home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / doors13.arc / MANUAL.ENG < prev   
Text File  |  1991-05-22  |  42KB  |  1,387 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                        DOORSWAP
  11.                                      Version 1.30
  12.                                    March/April 1991
  13.  
  14.  
  15.                                           by
  16.  
  17.                                      Volker König
  18.                                  Mettmanner Straße 71
  19.                                   4000 Düsseldorf 1
  20.                                        Germany
  21.  
  22.  
  23.  
  24.                                   FIDO: 2:241/4031.3
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                                   DOORSWAP.DOC Version 1.21
  71.                                                              April 10, 1991
  72.           
  73.           
  74.  
  75.  
  76.                                   Table of Contents
  77.  
  78.  
  79.                          1.    And another Utility          3
  80.                          1.1   The Shareware-Concept        4
  81.                          1.2   License-Agreement            5
  82.                          1.3   Warranty                     7
  83.  
  84.                          2.    System Requirements          8
  85.                          2.1   Hardware Requirements        8
  86.                          2.2   Software Requirements        8
  87.  
  88.                          3.    Installation                10
  89.                          3.1   The Swapfile                12
  90.                          3.2   RAM-Drives                  12
  91.                          3.3   Multiple Swapping           13
  92.  
  93.                          4.    Options                     14
  94.  
  95.                          5.    A little bit about the Future   16
  96.  
  97.                          6.    Error Messages              17
  98.  
  99.                          7.    Index                       19
  100.  
  101.                          8.    Historicals                 20
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.           
  127.           
  128.                                                                      Page 2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                   DOORSWAP.DOC Version 1.21
  137.                                                              April 10, 1991
  138.           
  139.           
  140.  
  141.           1. And another Utility
  142.              -------------------
  143.  
  144.           What's that, DOORSWAP?
  145.  
  146.           Many BBS-programs offer a function to call software, e.g.
  147.           databases, and - or better: mostly - games from within the BBS.
  148.           In some BBSes this function is realized not quite useful and
  149.           sometimes one must assume it is installed for optical reasons
  150.           only. 
  151.  
  152.           More and more external programs - just like Omen Software's DSZ -
  153.           are used instead of inventing the wheel for a second (third...)
  154.           time. At least transfer-protocols are much easier to update and
  155.           a BBS can use protocols and compression-routines unknown at
  156.           program's day-of-release simply by installing another child-
  157.           process. 
  158.  
  159.           To use these toolkits there must exist a possibility of calling
  160.           external programs from within the BBS - just what the BASIC-
  161.           command SHELL or the C-procedure SYSTEM does. Sometimes the DOOR-
  162.           or GAME-function seems to be installed basing on this small shell
  163.           in order to make the BBS look more professional. Most of the
  164.           programs called by such routines fail working just because they
  165.           do not get enough memory. 
  166.  
  167.           This was exactly the problem we got while installing Tradewars ][
  168.           on a BBS running under Forem-PC 2.3. Both worked without
  169.           bothering each other - except the crashdowns at every third or
  170.           fourth start of Tradewars. 
  171.  
  172.           "Why the hell isn't there a way to fool DOS?"
  173.  
  174.           There is one. 
  175.  
  176.           After lots of nights with few sleep, after some lost weekends,
  177.           after researching in magazines and books (specially at the
  178.           Düsseldorf public library and their collection of the german
  179.           computer-magazine "c't") DOORSWAP was born. 
  180.  
  181.           At this place I would like to say something about my english...
  182.           I've learned the english language for nine years at a german
  183.           school preparing for university; similar to the american "high
  184.           school". Since I finished school about six years ago there might
  185.           be some faults and errors in this manual. I would like to quote
  186.           God's Final Message to His Creature (as Douglas Adams assumes it
  187.           to be in his book 'So long and thanks for all the fish'): 
  188.  
  189.           WE APOLOGIZE FOR THE INCONVENIENCE
  190.  
  191.  
  192.           
  193.           
  194.                                                                      Page 3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                                   DOORSWAP.DOC Version 1.21
  203.                                                              April 10, 1991
  204.           
  205.           
  206.           1.1 The Shareware-Concept
  207.               ---------------------
  208.  
  209.           I think there is not much to be told about.
  210.  
  211.           DOORSWAP is a piece of commercial software. It is no 'freeware'
  212.           and not in the public domain. You must not use it (except for
  213.           evaluation) without having a written license. But there is one
  214.           difference between DOORSWAP and software sold in a store for lots
  215.           of money: You can copy and share and evaluate it with only few
  216.           restrictions. One of these restrictions is that DOOR.EXE, a part
  217.           of DOORSWAP, fails to work on every day that can be divided by 5
  218.           without modity (IF (DayOfMonth MOD 5) = 0). 
  219.  
  220.           Offer DOORSWAP in your BBS or your Software Library, evaluate
  221.           it's usability - but if you keep on using it regularly after
  222.           evaluating you will have to pay for it. 
  223.  
  224.           With this I give the right to copy and share the program DOORSWAP
  225.           given in the packet DOORS12.COM to the public domain as long as
  226.  
  227.           - no file or part is added, removed or changed
  228.           - it is distributed completely without any additional copyright-
  229.             notice as file DOORS121.COM
  230.           - it is not distributed in addition with or as part of any other
  231.             product (excluding collections of toolkits that can be shared
  232.             and copied without restrictions) 
  233.           - the fee for copying DOORSWAP or the collection containing
  234.             DOORSWAP does not extend US$ 3,-- / DM 5,--
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.           
  259.           
  260.                                                                      Page 4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                                   DOORSWAP.DOC Version 1.21
  269.                                                              April 10, 1991
  270.           
  271.           
  272.           1.2 License-Agreement
  273.               -----------------
  274.  
  275.           The german "Urhebergesetz", the law concerned with what is called
  276.           copyright in the english language, does not allow any use of
  277.           copyrighted materials without the prior consent of the person who
  278.           created the materials. Using them without consent can cause
  279.           criminal prosecution and can become very expensive. I think there
  280.           are laws (like the french "Code Punal") very similar in every
  281.           country. 
  282.  
  283.           For a fee of US$ 20,-- (cash, by order cheque or bank order) I
  284.           will ship your personal copy of DOORSWAP 1.30 including your
  285.           personal license-number and your BBS's name. And, of course,
  286.           without that ugly "evaluation"-message and the every-fifth-day-
  287.           restriction. The US$-20 - fee is the fee for orders outside
  288.           germany. For orders from inside germany see the file MANUAL.DEU. 
  289.  
  290.           This registered copy must not be copied anymore outside your BBS.
  291.           You can use it on as may ports of one BBS. For more than one
  292.           BBSes please contact me to get information about a site-license.
  293.           It might be cheaper than one single copy for each BBS. 
  294.  
  295.           In case you are already registered user of an older version of
  296.           DOORSWAP you can get an update to 1.30 for only US$-12,-- .
  297.  
  298.           Since I am interested in enhancing doorswap, changes for your
  299.           hardware or customizations to your needs are possible. 
  300.  
  301.           Please contact me for registration at the following address
  302.  
  303.           Volker König
  304.           Mettmannerstraße 71
  305.           W-4000 Düsseldorf 1
  306.           Germany
  307.  
  308.           You can pay either by order-cheque or cash. If you want to pay by
  309.           bank order I will not ship your registered version before the
  310.           money has reached my account. 
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.           
  325.           
  326.                                                                      Page 5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                                   DOORSWAP.DOC Version 1.21
  335.                                                              April 10, 1991
  336.           
  337.           
  338.           At registration please answer the following questions:
  339.  
  340.           At which BBS DOORSWAP
  341.           will be used?            ________________________________________
  342.           Phone-number:            _________________ Net?  ________________
  343.           BBS-Software:            ________________________________________
  344.           Online-Games(s):         ________________________________________
  345.           _________________________________________________________________
  346.           DOS-Version:             ________________________________________
  347.           additional software:     ________________________________________
  348.  
  349.           Hardware
  350.  
  351.                 o PC/XT                     Memory (+EMS/XMS) _______ kByte
  352.                 o PC/AT (80286)             Available for DOS _______ kByte
  353.                 o PC/AT (80386/80486)       RAM-Drive         _______ kByte
  354.                 o PS/2 Model  ______        __ Harddisk(s) with
  355.                                             _________ MByte Memory
  356.  
  357.           Of course these data are confidental. I will not tell anybody
  358.           about what your hardware and software is except it is necessary
  359.           to solve any problems. 
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.           
  391.           
  392.                                                                      Page 6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                                   DOORSWAP.DOC Version 1.21
  401.                                                              April 10, 1991
  402.           
  403.           
  404.           1.3 Warranty
  405.               --------
  406.  
  407.           You can imagine that I don't want to be responsible for any
  408.           damages at your hard- and/or software caused by DOORSWAP. To
  409.           cover the possible costs of only one crash I would have to sell
  410.           the registration of DOORSWAP for much more than US$-20.
  411.  
  412.           There is a warranty of six month stated in the german
  413.           "Bürgerliches Gesetzbuch", our civil law. I cannot avoid to
  414.           return the money if DOORSWAP does *really* not work but I think
  415.           you will have evaluated it before registering and you definitely
  416.           know the bugs. I also do not give any warranty except that
  417.           DOORSWAP will work on a 
  418.  
  419.           AT 286, manufactured by MANDAX (Taiwan), AMI-BIOS, Harddisk
  420.           ST225, Hercules-Graphic-Card, MS-DOS 3.20
  421.  
  422.           with FOREM-PC 2.30 and Tradewars ][.
  423.  
  424.           I am only responsible for faults, errors and damages if your
  425.           installation fits with mine. 
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.           
  457.           
  458.                                                                      Page 7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                                   DOORSWAP.DOC Version 1.21
  467.                                                              April 10, 1991
  468.           
  469.           
  470.           2   System Requirements
  471.               -------------------
  472.  
  473.           DOORSWAP should work properly on every MS-DOS computer having a
  474.           harddisk, not using the interrupt 62H for any other dirty
  475.           tricks and running with MS-DOS 3.20 or later. I had to take care
  476.           of some bugs of DOS 3.20 but they obviously did not change until
  477.           DOS 4.01. Who knows what later versions will bring up! 
  478.  
  479.           DOORSWAP did not work with GALACTIC WARZONE and FOREM-PC 2.3 on a
  480.           Commodore PC-10. Since WARZONE did not run without FOREM and
  481.           DOORSWAP just as well it seems to be a fault of this certain
  482.           Commodore-BIOS. 
  483.  
  484.  
  485.           2.1 Hardware Requirements
  486.               ---------------------
  487.  
  488.           There should exist a harddisk "C:" with about 700 kBytes of free
  489.           memory. 
  490.  
  491.           An advantage - but not required - is a communications-card
  492.           (COM-Port, RS232 or "serial Port") using an UART 8250 chip. As
  493.           you will realize starting DOOR.EXE this program looks out for
  494.           the first COM-Port having a carrier-detect (CD) signal set to
  495.           send a small copyright-notice. 
  496.  
  497.           Calling DOORSWAP always causes a delay depending in your
  498.           harddisk's speed. Not every BBS offers you a possibility to write
  499.           out a message like "please wait, DOORSWAP's working" to your COM-
  500.           Port. A short message about DOORSWAP and a little bit
  501.           merchandising won't insult anybody. 
  502.  
  503.           To find out to which COM-Port the modem is connected DOORSWAP
  504.           examines up to four ports for CD. The first one found carrying CD
  505.           is assumed to be active. If no CD is found no message will be
  506.           written to any COM-Port. 
  507.  
  508.           From version 1.30 on you can bypass this messages by using an
  509.           option (refer to 'options' in this manual) or let DOOR.EXE use an
  510.           installed FOSSIL-driver instead. 
  511.  
  512.           2.2 Software requirements
  513.               ---------------------
  514.  
  515.           The use of MS-DOS 3.20 is highly recommended. As I mentioned
  516.           before I had to use some DOS-functions that are not yet
  517.           documented by Microsoft. Especially the design of the memory
  518.           control blocks (MCB) is destined for internal use of DOS itself
  519.           and might change in later versions.
  520.  
  521.           But I did beta-tests on several DOS-Versions from 3.00 up to 4.01
  522.           
  523.           
  524.                                                                      Page 8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                                   DOORSWAP.DOC Version 1.21
  533.                                                              April 10, 1991
  534.           
  535.           
  536.           and there were no considerable problems. 
  537.  
  538.           RAM-drives and cache-memory must not be installed in DOS-memory,
  539.           please use Extended- or Expanded-Memory. Otherwise the whole DOS-
  540.           Memory might be swapped out including those areas reserved for
  541.           RAM-drive or cache what can easily bring up system crashes. 
  542.  
  543.           You can install device drivers (like ANSI.SYS) as before. Please
  544.           assure that they do not try to fool DOS just like DOORSWAP does.
  545.           It is also necessary to have them installed before DOORSWAP.COM
  546.           is loaded. Since DOORSWAP swapps out the whole memory behind the
  547.           end of DOORSWAP.COM all TSR-Programs loaded after DOORSWAP.COM
  548.           will disappear while the external program works. 
  549.  
  550.           But the evaluation-copy is made just for testing where there are
  551.           problems caused by other TSR's. Keyboard-drivers and other useful
  552.           things like SIDEKICK and it's clones will normally cooperate
  553.           without problems. 
  554.  
  555.           Just like the BBS-program the externally loaded software must not
  556.           try to fool DOS. You should not install any resident software
  557.           after the memory has been swapped out because they will be
  558.           deleted from RAM loading the memory back. 
  559.  
  560.           Problems might come up using FOSSIL-drivers (like X00.SYS or
  561.           BNU.SYS) although they did not come up at the beta-test. Normally
  562.           DOS manages the entry-points of interrupts itself by writing them
  563.           into a special area of RAM. DOORSWAP and DOS can see where and
  564.           where not a vector has been changed since installation of
  565.           DOORSWAP.COM and restore it to it's previous value. FOSSIL-
  566.           drivers can chain new processes into the ticker-interrupt or the
  567.           INT 14H (COM-Port) bypassing this convention. More about this
  568.           problem in a later part. 
  569.  
  570.           A RAM-drive can be installed in either Extended- or Expanded
  571.           memory. If it is so you can keep on using it. A RAM-drive or a
  572.           cache-program using DOS-memory can not be used. 
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.           
  589.           
  590.                                                                      Page 9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                                   DOORSWAP.DOC Version 1.21
  599.                                                              April 10, 1991
  600.           
  601.           
  602.           3.    Installation
  603.                 ------------
  604.  
  605.           There is not to say much about installing DOORSWAP. As you will
  606.           already have realized DOORSWAP consists of two separate programs:
  607.           DOORSWAP.COM and DOOR.EXE. DOORSWAP.COM is the resident portion.
  608.           Installed it saves the current interrupt vectors and moves one of
  609.           them to it's own entry-point.
  610.  
  611.           DOOR.EXE is the activating part. As parameter it needs the
  612.           previous commandline used to call the external program. DOOR.EXE
  613.           finds out which COM-Port is used, and what COMSPEC and DSFILE are
  614.           set to. After that DOORSWAP.EXE is activated by calling it's
  615.           interrupt and passing some data. 
  616.  
  617.           Those data are
  618.  
  619.           - name and path of the commandline interpreter (defaults to
  620.             C:\COMMAND.COM
  621.           - parameter for calling the interpreter ("/C " plus the
  622.             commandline)
  623.           - name and path of the swap-file defined in DSFILE (defaults to
  624.             C:\DOORSWAP.DAT)
  625.  
  626.           I assume most BBS-programs are installed inside a BATCH-loop
  627.           that is called by AUTOEXEC.BAT. If this is your installation I
  628.           would propose to call DOORSWAP.COM as the last program before
  629.           entering the BBS-batch from AUTOEXEC.BAT. 
  630.  
  631.           If your BBS is running in a loop inside AUTOEXEC.BAT DOORSWAP.COM
  632.           should be called as the last program before entering the loop.
  633.  
  634.           NOTE: Multiple installations are still possible with version 1.3.
  635.           The single installations of DOORSWAP.COM will not bother each
  636.           other but they will waste about 6 kBytes of memory for each of
  637.           them. 
  638.  
  639.           From inside the BBS there are different ways to install the
  640.           activating program DOOR.EXE in the most efficient way.
  641.  
  642.           In the majority of cases external programs will be called as a
  643.           shell-function. The BBS-program is told how you would call the
  644.           external program from DOS. Assuming the external program is
  645.           named GAME.EXE and needs the number of the COM-port or the word
  646.           LOCAL passed as parameter it would be called from DOS:
  647.  
  648.           GAME COM1
  649.  
  650.  
  651.  
  652.  
  653.  
  654.           
  655.           
  656.                                                                     Page 10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                                   DOORSWAP.DOC Version 1.21
  665.                                                              April 10, 1991
  666.           
  667.           
  668.           This is exactly what you have to tell the BBS to call GAME.EXE.
  669.           Calling it via DOORSWAP change it to 
  670.  
  671.           DOOR GAME COM1
  672.               /^^^^^^^^^
  673.              (former commandline)
  674.  
  675.           You just have to call DOOR.EXE passing the former commandline as
  676.           parameter string. This very simple installation is possible e.g.
  677.           at FOREM PC or SearchLight BBS and many other programs. You do
  678.           not need to change anything but the commandline. 
  679.  
  680.           Some very simple implementations of door functions use the first
  681.           word of the commandline as the BBS-command the user has to enter
  682.           in order to start the external program. In the case previously
  683.           described the commandline 
  684.  
  685.           GAME COM1
  686.  
  687.           would mean the program would have to be called with the BBS-command
  688.           GAME (the 1st word of the commandline executed). Since normally
  689.           the names of the programs called from within the BBS are
  690.           different there will be no problems with it - unless you use
  691.           DOORSWAP. Now DOOR will be the very first word of more than one
  692.           commandline and this will cause either an error-message or that
  693.           only one of the programs installed can be called by the user. 
  694.  
  695.           You can avoid problems by creating BATCH-files do call the
  696.           different programs. Within this BATCH-file you call the
  697.           external program using the former new commandline. In our
  698.           example the BATCH-file could be named GAME.BAT and be placed in
  699.           the DOS-directory or the BBS-directory. It should contain: 
  700.  
  701.           CD C:\GAME1
  702.           DOOR GAME COM1
  703.           CD C:\BBS
  704.  
  705.           You can further write out messages to your COM-Port with the
  706.           COPY-command or use the CLS-command to clear the local screen. 
  707.  
  708.           NOTE:
  709.           -----
  710.  
  711.           After installing DOORSWAP.COM there must be at least one program
  712.           installed or loaded. Calling DOOR.EXE from the same COMMAND-Shell
  713.           where DOORSWAP was installed is nonsense because DOORSWAP will
  714.           not be able to free more memory than available at that moment
  715.           anyway, and will end up in a system crash. 
  716.  
  717.  
  718.  
  719.  
  720.           
  721.           
  722.                                                                     Page 11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                                   DOORSWAP.DOC Version 1.21
  731.                                                              April 10, 1991
  732.           
  733.           
  734.           3.1 The Swapfile
  735.               ------------
  736.  
  737.           From version 1.20 you will have the option to change the swapfile's
  738.           name. The new name you choose should be fully qualified, that
  739.           means it should consist of drive, path (starting with '\') and
  740.           filename. The name is set using the environment variable DSFILE.
  741.           Use the command 
  742.  
  743.           SET DSFILE=xxx
  744.  
  745.           to set DSFILE. If DSFILE is not set the filename C:\DOORSWAP.DAT
  746.           is used.
  747.  
  748.           The name should be fully qualified. If there are parts missing
  749.           the current settings (current drive and/or path) will be used. In
  750.           case the program called changes either path or drive the swapfile
  751.           will not be found to reload the memory. A system crash cannot be
  752.           avoided in this case, so use qualified names.
  753.  
  754.           The following errors are possible:
  755.  
  756.           C:DOORSWAP.DAT
  757.  
  758.           The file DOORSWAP.DAT will be placed in the current path of drive
  759.           C:. If another path and/or drive is set after exiting the
  760.           external program reloading memory is impossible.
  761.  
  762.           \BBS\DOORSWAP.DAT
  763.  
  764.           The file will be located in the path \BBS\ of the current drive.
  765.           If the drive is changed after execution of the external program
  766.           there is a real problem ;-)
  767.  
  768.           TEMP\DOORSWAP.DAT
  769.  
  770.           The path .\TEMP\ is used to place the swapfile in. Since "." is a
  771.           synonym for the current path DOORSWAP.DAT will be placed in the
  772.           sub-directory TEMP of the current path. If the external program
  773.           changes current path and/or drive the reloading might cause
  774.           problems.
  775.  
  776.           3.2 RAM-Drives
  777.               ----------
  778.  
  779.           You can use the option described to use a RAM-drive as a
  780.           swapping-drive. You must be sure that there is enough memory on
  781.           this RAM-dive to hold the swapfile that can grow up to about 600
  782.           kBytes. The swapping will become terribly fast.
  783.  
  784.  
  785.  
  786.           
  787.           
  788.                                                                     Page 12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                                   DOORSWAP.DOC Version 1.21
  797.                                                              April 10, 1991
  798.           
  799.           
  800.           3.3 Multiple Swapping
  801.               -----------------
  802.  
  803.           The possibility of customizing the name of the swapfile can be
  804.           used for some tricks.
  805.  
  806.           If the called program itself can call external programs but does
  807.           not free enough memory you can install DOORSWAP.COM for a second
  808.           time and swap out the memory into a second swapfile. A sample
  809.           installation in a very, very short form:
  810.  
  811.           The BBS used is named BBS.EXE. There exist two different
  812.           installations, one in path INST_1 and one in INST_2. Maybe you
  813.           want to call installation 2 from installation 1 because you are
  814.           participating in two different networks. 
  815.  
  816.           The BATCH-file calling the *first* BBS should contain the
  817.           following lines:
  818.  
  819.           [...]
  820.           CD \INST_1
  821.           SET DSFILE=C:\BBS\DOORSWAP.001
  822.           BBS
  823.           [...]
  824.  
  825.           The BATCH-file calling the *second* installation should contain
  826.           the following lines:
  827.  
  828.           [...]
  829.           DOORSWAP
  830.           CD \INST_2
  831.           SET DSFILE=C:\BBS\DOORSWAP.002
  832.           BBS
  833.           [...]
  834.  
  835.           Look at the names DSFILE is set to and the second installation of
  836.           DOORSWAP.COM.
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.           
  853.           
  854.                                                                     Page 13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                                   DOORSWAP.DOC Version 1.21
  863.                                                              April 10, 1991
  864.           
  865.           
  866.           4. Options
  867.              -------
  868.  
  869.           From version 1.30 some options are available to customize
  870.           DOORSWAP to your needs. They are enabled or disabled by setting
  871.           the environment variable DSOPT to a string containing several
  872.           keywords seperated by commas. An example for such a definition
  873.           would be:
  874.  
  875.  
  876.           SET DSOPT=DEL;FOSOUT;FOSINIT
  877.  
  878.           Now the options in particular:
  879.  
  880.           DEL      - delete swap-file after use
  881.  
  882.           Using this option causes DOOR.EXE to delete the swap-file after
  883.           loading back memory. You can use this if the memory on your
  884.           harddisk used by the swap-file is needed for other things,
  885.           importing messages from or exporting them to a network like
  886.           FidoNet.
  887.  
  888.  
  889.           COMx     - tell DOOR.EXE which COM-port is to be used
  890.  
  891.           This option causes DOOR.EXE to make use of the COM-Port defined
  892.           instead of the 'x'. If your BBS does have more than one ports the
  893.           search for the first carrier-detect can cause the messages to be
  894.           sent to the wrong BBS. Also a non-standard-UART can cause
  895.           problems. You can also use COM0 to suppress the use of any COM-
  896.           port.
  897.  
  898.  
  899.           FOSOUT   - use FOSSIL-driver to write messages to COM-port
  900.  
  901.           You can force DOORSWAP to use the FOSSIL-driver you have possibly
  902.           installed to write the messages to the COM-port. I can only
  903.           propose the use of a FOSSIL-driver to avoid complications by
  904.           'unauthorized' use of the port.
  905.  
  906.  
  907.           FOSINIT  - initialize FOSSIL-driver after loading
  908.  
  909.           Some online games do not manage to return the COM-port to the BBS
  910.           in the status they found it. There could interrupt-masks be
  911.           abused, interrupt-vectors (also of FOSSIL) dismanaged and so on.
  912.           You can assume this to have happened if the BBS does not accept
  913.           any input at least via COM-port after returning. 
  914.  
  915.           This is originally no problem caused by DOORSWAP, but DOORSWAP
  916.           can help solving it. In case your BBS makes use of a FOSSIL-
  917.           driver you can re-initialize this driver to the port used after
  918.           
  919.           
  920.                                                                     Page 14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                                   DOORSWAP.DOC Version 1.21
  929.                                                              April 10, 1991
  930.           
  931.           
  932.           loading the memory. In some (not all) cases it will solve
  933.           problems.
  934.  
  935.  
  936.           And here a further example for the use of multiple options:
  937.  
  938.           since your harddisk is slow you want DOORSWAP to write it's
  939.           message to COM2 in order to make the user aware of why it takes
  940.           such a long time. COM2 is recommended to be used since you are
  941.           driving two ports within a multitasking-environment.
  942.  
  943.           Each morning you are polling from your boss the free space on
  944.           your harddisk becomes rare. So you want DOORSWAP to delete its
  945.           swap-file after loading back the memory. In addition you want
  946.           your FOSSIL-driver (X00.SYS) to be initialized since THE PIT does
  947.           not return the port properly. Also FOSSIL should be used to write
  948.           the messages to avoid any trouble that can be avoided.
  949.  
  950.           To reach this you have to set DSOPT somewhere - possible in
  951.           AUTOEXEC.BAT by the following commandline:
  952.  
  953.           SET DSOPT=COM2;DEL;FOSINIT;FOSOUT
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.           
  985.           
  986.                                                                     Page 15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                                                   DOORSWAP.DOC Version 1.21
  995.                                                              April 10, 1991
  996.           
  997.           
  998.           5.  A little bit about the future
  999.               -----------------------------
  1000.  
  1001.           Yes, DOORSWAP shall be enhanced in later versions.
  1002.  
  1003.           If there grow up problems on different systems than the ones I
  1004.           have tested, DOORSWAP will be changed to work on these systems,
  1005.           too. But for this I need your support. If you find any problems -
  1006.           contact me. Of course you can also contact me before registering
  1007.           since I am of the opinion that the evaluation of a shareware-
  1008.           program is the only way to find bugs.
  1009.  
  1010.           Let me tell some word about things I intend to change in future
  1011.           versions.
  1012.  
  1013.           It is planned to let you select the interrupt-vector used to
  1014.           activate DOORSWAP. Perhaps some software uses int 62H itself and
  1015.           might conflict with DOORSWAP. 
  1016.  
  1017.           And some day I will think about a way to avoid wrong multiple
  1018.           installations of DOORSWAP.COM.
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.           
  1051.           
  1052.                                                                     Page 16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                                   DOORSWAP.DOC Version 1.21
  1061.                                                              April 10, 1991
  1062.           
  1063.           
  1064.           6 Error Messages
  1065.             --------------
  1066.  
  1067.           Some easy-to-understand messages could be caused by the runtime-
  1068.           library of Fitted Software Tools' Modula-2 compiler. DOOR.EXE is
  1069.           written completely in M2. There is not much to do about them.
  1070.  
  1071.           DOORSWAP.COM can write out error messages while swapping, too.
  1072.           They are - as I think - self-declaratory and do not say anything
  1073.           important. In fact they only tell something about a missed try to
  1074.           fool DOS. If DOORSWAP works correctly and the error message is
  1075.           sent it is just caused by an unexpected response of any DOS-
  1076.           function. In this case you won't be able to change it unless you
  1077.           send me a copy of your DOS - please DON'T do so. If DOORSWAP
  1078.           works this message won't bother anybody.
  1079.  
  1080.           The only messages interesting for DOORSWAP-users are the ones
  1081.           written out while loading COMMAND.COM. 
  1082.  
  1083.           In former versions I have been to lazy to let DOORSWAP.COM or
  1084.           DOOR.EXE write out those messages returned from DOS by a numeric
  1085.           code. To make it easy I just added 0x20 (chr$(32)) to make the
  1086.           DOS-response-code visible as an ASCII-char. 
  1087.  
  1088.           From version 1.21 DOOR.EXE will analyze the code after returning
  1089.           from interrupt-action. All these messages are concerned with
  1090.           COMMAND.COM or whatever commandline-interpreter you are using.
  1091.  
  1092.           6.1 'returned from DOORSWAP without Error.'
  1093.  
  1094.           Lucky guy, it works!
  1095.  
  1096.           6.2 'FATAL ERROR: Illegal call of DOS-Function.'
  1097.  
  1098.           It seems to be a very fatal error: the DOS-function used to start
  1099.           a child-process cannot make sense of the parameters passed to it
  1100.           by DOORSWAP. Check whether or not there are unauthorized changes
  1101.           in either DOOR.EXE or DOORSWAP.COM. If not: Possibly you are
  1102.           using a DOS older than 3.0 ?
  1103.  
  1104.           6.3 "COMSPEC 'C:\COMMAND.COM' not found!"
  1105.  
  1106.           The file 'C:\COMMAND.COM' (or whatever is defined in COMSPEC) is
  1107.           not found. Please check this.
  1108.  
  1109.           6.4 "Out of memory error: can't load 'C:\COMMAND.COM'!"
  1110.  
  1111.           This should really not happen, because DOORSWAP first swaps out
  1112.           memory and frees it for DOS and then loads COMMAND.COM. Possibly
  1113.           the memory-management of your DOS-version differs from what was
  1114.           'normal' at DOS 3.xx. 
  1115.  
  1116.           
  1117.           
  1118.                                                                     Page 17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                                   DOORSWAP.DOC Version 1.21
  1127.                                                              April 10, 1991
  1128.           
  1129.           
  1130.           6.5 "ERROR in file 'C:\COMMAND.COM' - maybe bad EXE"
  1131.  
  1132.           Your COMSPEC-File is an EXE-File having a damaged header. Replace
  1133.           it by a copy from your DOS-Mastercopy (if you have one)
  1134.  
  1135.           6.6 'Unknown Error.'
  1136.  
  1137.           DOS returns an error-code unknown at versions up to DOS 4.01.
  1138.           Use an older DOS-Version. 
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.           
  1183.           
  1184.                                                                     Page 18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                                   DOORSWAP.DOC Version 1.21
  1193.                                                              April 10, 1991
  1194.           
  1195.           
  1196.           7. Index
  1197.              -----
  1198.  
  1199.              activating program       10       MS-DOS                    8
  1200.              Address                   5       multiple installation    10
  1201.              ANSI.SYS                  9
  1202.              AUTOEXEC.BAT             10       options                   8
  1203.  
  1204.              Bank order                5       parameter                10
  1205.              BAT                      10       price                     4
  1206.              batch                    10
  1207.              BNU.SYS                   9       RAM-drive                 9
  1208.                                                Registration fee        4,5
  1209.              Cache memory              9       resident part            10
  1210.              carrier-detect            8       RS232                     8
  1211.              COM port                  8
  1212.              COMMAND.COM              10       serial port               8
  1213.              Commodore PC 10           8       Shareware                 4
  1214.              compression               3       SHELL                     3
  1215.              COMSPEC                  10       SideKick                  9
  1216.                                                Software Library          4
  1217.              databases                 3       software requirements     8
  1218.              device drivers            9       SYSTEM                    3
  1219.              disk space                8       System requirements       8
  1220.              DOOR-function             3
  1221.              DOOR.EXE                 10       ticker-interrupt          9
  1222.              DOORSWAP.COM             10       Tradewars ][              3
  1223.              DSFILE                   10       transfer-protocols        3
  1224.              DSZ                       3       TSR                       9
  1225.  
  1226.              environment              10       UART 8250                 8
  1227.              extended memory           9
  1228.              external programs         3       Warranty                  7
  1229.  
  1230.              FoReM PC                  3       X00.sys                   9
  1231.              FOSSIL                  8,9
  1232.  
  1233.              GALACTIC WARZONE          8
  1234.              GAME-function             3
  1235.              God                       3
  1236.  
  1237.              harddisk                  8
  1238.  
  1239.              installation             10
  1240.              INT 62h                   8
  1241.  
  1242.              keyboard-drivers          9
  1243.  
  1244.              License Agreement         5
  1245.  
  1246.  
  1247.  
  1248.           
  1249.           
  1250.                                                                     Page 19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                                                   DOORSWAP.DOC Version 1.21
  1259.                                                              April 10, 1991
  1260.           
  1261.           
  1262.           8. Historicals
  1263.              -----------
  1264.  
  1265.           And here some small sentences about DOORSWAP's history.
  1266.  
  1267.  
  1268.           03.08.1990       1st release of DOORSWAP 1.0. Also date of the
  1269.                            authorized package DOORS10.COM
  1270.  
  1271.           03.11.1990       Start of work at DOORSWAP 1.1. 
  1272.                            Especially some bad manners of TurboPascal
  1273.                            3.00's runtime-library had to be changed. TP3.0
  1274.                            normally uses own screen-output based on the INT
  1275.                            10H of the BIOS. At startup it tries to force
  1276.                            the display into a defined mode. That was a
  1277.                            problem at some 'compatible' BIOSses and
  1278.                            graphic-cards. 
  1279.                            It was fooled by changing the output to STDOUT.
  1280.                            V1.1 of DOORSWAP was not published as shareware
  1281.                            but used to register from May '90 on.
  1282.  
  1283.           11.22.1990       Release of DOORSWAP 1.2. There are the following
  1284.                            changes:
  1285.                            - DOOR.EXE, former DOOR.COM, is coded in
  1286.                              Modula-2 instead of Pascal. Since I own the
  1287.                              library-sources of this compiler I definitely
  1288.                              know there won't be problems with your BIOS.
  1289.                            - DOOR.EXE now detects the presence of
  1290.                              DOORSWAP.COM V1.2.
  1291.                            - DOOR.EXE evaluates the environment-variable
  1292.                              DSFILE to determine the swapfile's name.
  1293.  
  1294.  
  1295.           28.02.1991       Release of DOORSWAP 1.21. I made some small
  1296.                            optical changes and a bugfix.
  1297.                            There were indeed problems with some COM-ports.
  1298.                            They were not found by DqOOR.EXE and so on some
  1299.                            systems a random-address found somwhere in DOS-
  1300.                            memory was assumed to be the active COM-Port. On
  1301.                            other systems with less than four ports the
  1302.                            value of 0H of not existing COM-ports in the
  1303.                            DOS-table was assumed to be Ok. At 0H there is
  1304.                            the DMA-controller which looks not unlike an
  1305.                            avtive COM-port. So the message was written to
  1306.                            the DMA-controller - causing strange meditation-
  1307.                            sessions of the system. Since I couldn't
  1308.                            reproduce these errors on my system I coudn't
  1309.                            avoid them. Sorry for this.
  1310.  
  1311.           05.04.1991       Beta tests of V 1.30 are done. slowly the
  1312.                            release of V 1.30 comes closer.
  1313.                            The following changes have been made:
  1314.           
  1315.           
  1316.                                                                     Page 20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                                                   DOORSWAP.DOC Version 1.21
  1325.                                                              April 10, 1991
  1326.           
  1327.           
  1328.                            - evaluation-copy does not work each day.
  1329.                            - now you can suppress the messages.
  1330.                            - FOSSILs can be used for output.
  1331.                            - FOSSILs can be re-initialized
  1332.                            - DOOR.EXE can delete the swap-file
  1333.                            - the messages are made a bit more beautiful.
  1334.                            Some BBSes do not write CR's past the input of a
  1335.                            command. So the messages sometimes were written
  1336.                            into the same line the command was entered.
  1337.                            - the documentation contains an alphabetical
  1338.                            index.
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.           
  1381.           
  1382.                                                                     Page 21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.